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1.0 INTRODUCTION 

This document describes the differences between BASIC/RT-11 V0O1B_ and 
BASIC-11/RT-1l11 v2. It also lists some restrictions you should be 
aware of when using BASIC-ii/RT-il VZ. This document describes the 
procedure you should follow to install BASIC-11 on your RT-11 V03 
system. Lastly, it shows how to use the program SUCVT to convert 
BASIC/RT-11 VO1B programs to a format suitable for BASIC-1l1/RT-11 V2. 


The following documentation conventions are used throughout this 
manual: 


1. Square brackets [ ] enclose optional items. 
2. Braces {} enclose items from which you must choose only one. 


3. Upper case letters represent keywords that you must type as 
shown. 


4. Lower case letters represent variables for which you supply 
values. 


5. Ellipses ... indicate that the immediately preceding item 
can be repeated. 


6. User input is underlined where necessary to distinguish it 
from computer printout. 


7. The abbreviation "expr" represents expression. 


8. The symbol represents a carriage return. 


2.0 CHANGES FROM BASIC/RT-11 VO1B 
This section summarizes the differences between BASIC/RT-11 V01B_ and 


BASIC-11/RT-11 V2. You can find more information on BASIC-11/RT-11 V2 
in the following two documents: 


BASIC-11 Language Reference Manual 
Order No. DEC-lII-LIBBB-A-D 
BASIC-11/RT-11 User's Guide 
Order No. DEC-11-LIBUA-A-D 


For more information on the RT-11 V03 operating system, consult’ the 
following guide: 


RT-11 Documentation Directory 
Order No. DEC-11-ORDDB-A-D 


Table 1 lists the new features of BASIC-11/RT-11 V2. 
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Table l 
New Features of BASIC-11/RT-11 V2 


Integer Data Type = 











Double Precision Data Type 



























COMMON 

DIM# 

KILL 

LINPUT 

NAME 

ON GOTO 

ON GOSUB 

ON THEN 
PRINT USING 
RESET 


Statements 


ABORT 
CTRLC 
LOG10 
PI 
RCTRLC 
RCTRLO 
SYS 


TTVSET 


eta 


Functions 





APPEND 
BYE 
COMPILE 
DEL 
LENGTH 
RESEQ 
SUB 
UNSAVE 
CTRL/Q 
CTRL/S 


Commands 


Some statements, functions, and commands are not entirely new in 
BASIC-11/RT-11 V2, but have syntactical or functional differences from 
their counterparts in BASIC/RT-11 V0O1B. Tables 2, 3, and 4 list both 
the old and new statements, functions, and commands. The tables also 
provide a brief explanation of the changes. 
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Table 2 
Changes in Statements from 
BASIC/RT-11 V01B to BASIC~-11/RT-~11 V2 


| Version | Statement | 





VO1B 


V2 


v0O1B 


"] [argument list)] 


CALL ["] routine name 
In V2, the quotation marks delimiting the routine names 
are optional. 

CHAIN "string" LINE number. 

CHAIN string [LINE expression] 


In V2, the line number specification can be an 
expression. 


cuse[{"" 


(én J 
CLOSE [[#] expr1, [¥] expr2, [i expr3,...] 


In V2, the pound sign (#) is optional. You can specify 
more than one file, and the file specification can be 


an expression. The VFn syntax is no longer permitted. 


DATA list 


DATA list 


In V2, unquoted strings are permitted. The DATA 
statement must be .the last statement on a 
multi-statement line. 


DEF FNletter (varl[,var2,...var5])=expression 
$ 

DEF FNletter (varl[,var2,...,var5]})=expression 
% 


In v2, if the function returns a string, the function 
name (FNletter) must end with a dollar sign ($). If 
the function returns an integer, the function name must 
end with a percent sign (%). 


THEN 
line number 


IF relational expression 


GO TO 


( THEN 
IF END #n line number 


GO TO 


(continued on next page) 
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Table 2 (Cont.) 
Changes in Statements from 
BASIC/RT-11 V01B to BASIC-11/RT-11 V2 





Version 














THEN statement 
IF relational expression {THEN line number 
GO TO line number 


THEN statement 
IF END #expr THEN line number 
GO TO line number 


In V2, the THEN keyword can be followed by a statement 
as well as by a line number. 





INPUT variablel[,variable2,...] 
INPUT [#expr,] variablel[,variable2,...] 


In V2, you can type more than one string on a line. 


INPUT #¥expr: variablel[,variable2,...] 













INPUT [#expr,] variablel[,variable2,...] 






DIGITAL recommends that you follow the expression by a 
comma (,) rather than by a colon (:), even though the 
colon is still permitted. 
(Let] variable=expression 
LET] vFn(i)=expression 
[LET] variable=expression 

In V2, the VF format is not permitted. 


INPUT 





[(b)] AS FILE #digit [DOUBLE BUF] 


OPEN file | FOR 
OUTPUT, 


OPEN file ron| {oareo Ife>s FILE VFdigit (dimension)=string length 


OUTPUT 


FOR INP 
OPEN string [tren anal AS FILE [+] expr [pouste Bur] 


| necorpsize expr| [ Move expr | [ Frueszze expr | 


In V2, the file specification can be any string 
expression. The pound sign (#) is optional. Specify a 
file size by using the FILESIZE keyword. The VF format 
is not permitted. 












(continued on next page) 
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Table 2 (Cont.) 
Changes in Statements from 
BASIC/RT-11 VO1B to BASIC-11/RT-11 V2 


| Version | Statement | 


volB OVERLAY "file descriptor" 


| 
v2 | OVERLAY string [LINE expression] 


expression. 
VO1B PRINT #expr: list 
v2 PRINT [#expr,] [list] 


DIGITAL recommends that you follow the expression by a 
comma (,) rather than by a colon (:), even though the 
colon is still permitted. 

VO1B RANDOMIZE 

V2 RANDOMIZE 
In V2, the random number generator starts at a new 
number each time the statement is executed. 


V01B REM comment 


| 
In V2, the line number specification can be an 
V2 REM comment 


| | In V2, you can terminate a comment by a backslash (\). | 


Table 3 
Changes in Functions from 
BASIC/RT-11 V01B to BASIC-11/RT-11 V2 


Version Function 


V0O1B ASC (string) 
V2 ASC (string) 


In V2, this function returns an 8-bit (rather than 
77-bit) value. 


BIN ((Jstring [) 





(continued on next page) 
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Table 3 (Cont.) 
Changes in Functions from 
BASIC/RT-11 VO1B to BASIC-11/RT-11 V2 


Version Function 


v2 BIN (string) 





















In V2, the 
required. 


parentheses delimiting the argument are 
volB CHRS (expr ) 
V2 CHRS (expr) 
In V2, this function accepts an 8-bit (rather than 
7-bit) value. 
vVo1B ocT [(JstringP] 
v2 ocT (string) 
In V2, the parentheses delimiting the argument are 
required. 
STRS (expr ) 


STRS§ (expr) 






In V2, this function can return more than six digits 
(with double precision arithmetic). 


Table 4 
Changes in Commands from 
BASIC/RT-11 V01B to BASIC-11/RT-11 v2 


Version Command 


VO1B LISTENHI 
LISTENHJ line number 
LISTENHJ-line number 
LISTENHJ line number - [END] 
LISTENH) line number ~ line number 


LIST[NH] [line specificationl,line specification2,...] 


In V2, you can list more than one line range 
specification. The END specification is no longer 
allowed. The other VO1B forms of the command are still 
valid in V2. 





(continued on next page) 
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Table 4 (Cont.) 
Changes in Commands from 
BASIC/RT~11 V0O1B to BASIC-11/RT-11 V2 


NEW "program name". 

OLD “file specification" 
RENAME “program name" 
REPLACE "file specification" 
SAVE "file specification" 


NEW [program name] 

OLD [file specification] 
RENAME program name 
REPLACE file specification 
SAVE [file specification] 


In V2, these.commands must not contain quotation marks 
that delimit the file specifications. 


RUN 


RUNNH 


RUN (NHJ 
RUN{NH] file specification 


In V2, you can include a file specification in the RUN 
and RUNNH commands. 


CTRL/C 


In V2, CTRL/C ‘returns control'to: BASIC (in VO1B, it 
returned control ‘to the RT-11 monitor). CTRL/C also 


prints the line number of the line that was executing 
when it interrupted the program. 


| Version | Command | 


| 
V2 
VO1B 





Table 5 lists changes in . miscellaneous features fon BASIC/RT-11 V01B 
to BASIC-11/RT-1l1 v2. 
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Table 5 
Changes in Miscellaneous Features from 
BASIC/RT-11 V0O1B to BASIC-11/RT-11 V2 


ee ee ee 


Maximum line 
number 








In V2, the maximum line number is 32767 (in 
VO1B, it was 65532). 










String concate- In V2, the string concatenation operator 
nation operator can be either the ampersand (&) or the plus 
sign (+) {in VO1B it was the ampersand). 


Virtual arrays In V2, virtual arrays are like arrays in 
memory (except that they are not zeroed at 
run time); they do not have special 
variable names. Virtual arrays can have 
one or two subscripts (V01B allowed just 
one subscript). The string length can have 
any value between 1 and 255; it does not 
have to be a power of 2. The default 
string length is 16 (in VO1B, it was 32). 


Terminal width In V2, the terminal width can be set from 1 
to 255 characters. See the BASIC-11/RT-11 
User's Guide for a description of the 
TTYSET function. 





Closing files In v2, files are closed by the CLOSE or END 
statement (or by execution of the last line 
of the program) but are left open by the 
STOP statement. Any open output files are 
deleted by the RUN, SCR, OLD, and NEW 
commands. (In V0O1B, STOP, RUN, SCR, OLD, 
and NEW closed files.) 


Deleting a character In V2, the DELETE (or RUBOUT) key deletes a 
character; the backarrow (or underscore) 
key does not. (Both DELETE and backarrow 
were valid in V0O1B.) 


Deleting a line In v2, the CTRL/U command deletes a line; 
the ESCAPE (or ALTMODE) key does not. 
(Both CTRL/U and ESCAPE were valid in 
VO1B.) 


Lower case In V2, lower case keywords and variable 
names are always converted to upper case. 
Lower case string constants and remarks are 
permitted. 


(continued on next page) 
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Table 5 (Cont.) 
Changes in Miscellaneous Features from 
BASIC/RT-11 VO1B to BASIC-11/RT-11 V2 


Feature 





I 
Arithmetic hardware BASIC~11/RT-11 V2 supports the following 
support hardware (V0O1B also supported this 
hardware): 


EAE KE11-A and KE11-B 
Extended Arithmetic Element 


EIS KE11-E 
Extended Instruction Set 


FPU FP11-A, FP11-B, and FP11-c 
Floating Point Unit 


Support of the following hardware is new in 
V2: 


FIS KE11-F 
Floating Point Instruction Set 
KEV-11 
Extended Arithmetic Element 


CALL interface In V2, the CALL interface is similar to the 
FORTRAN Iv CALL interface. Note that 
“arrays are stored with the second subscript 
varying faster; they are stored 
independently of the scalar with the same 


. 
name. Many intarnal tahle formats ana 










sles eset Se se Petite eee) aaa 


offsets have changed. See the 


BASIC-11/RT-1l_ User's Guide for a complete 






description of the CALL interface. 


3.0 RESTRICTIONS IN BASIC-11/RT-11 v2 


BASIC-11/RT-11 users should always keep abreast of BASIC-related 
notices published by DIGITAL. Changes published in the Software 
Performance Summary need be made only once and should be made 
immediately. Changes published in the Digital Software News should be 
made as soon as possible to systems in use. The following sections 
summarize the restrictions in BASIC-11/RT-11 V2 of which you should be 
aware. 


3.1 Floating Point Operations 


Since whole floating point numbers are not stored as integers, 
execution of floating point operations can be slower than in VO1B, in 
certain circumstances. To avoid this problem, convert the data from 
floating point to integer by specifying the percent sign (%) wherever 
possible. 
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3.2 READ Statement 


Since a list created by a data statement is stored in ASCII format 
(rather than in a binary internal format), the READ statement requires 
additional time to translate data items. 


3.3 REM Statement 


A REM statement terminated by a backslash (\) gets longer by one space 
each time a program containing it is saved by the SAVE command. If a 
program containing such a line is called and saved (with the OLD and 
SAVE commands) several times, the line can become too long for BASIC 
to handle properly. Use the SUB command to delete the extra spaces 
before the line gets too long. 


3.4 Subscripts 


BASIC calculates subscripts by performing an INT function rather than 
by using true truncation. This method of calculating subscripts 
causes no problems with positive subscripts. It also causes no 
difficulty with subscripts of -1l or less, since BASIC does not support 
negative subscripts. However, BASIC does give an error (?SUBSCRIPT 
OUT OF BOUNDS) for A(-.5). 


3.5 GOSUB Statement 


An immediate mode GOSUB to a routine that has an INPUT or LINPUT 
statement can crash BASIC, under certain circumstances. This can 
occur because BASIC uses the same area of memory to process both 
immediate mode statements and terminal . input. When BASIC returns 
control to the line with the immediate mode GOSUB statement, that line 
has been overwritten by the terminal input (from the INPUT or LINPUT 
statement). To avoid this problem, use an immediate mode GOTO 
statement in place of the GOSUB statement. This causes BASIC to 
execute the subroutine, print a warning, and then print the READY 
message. 


3.6 COMPILE Command | 


The COMPILE command generates a file with a .BAC file type under BASIC 
with single precision arithmetic. Similarly, it generates a file with 
a .BAX file type under BASIC with double precision arithmetic. If you 
use an OLD, RUN, or CHAIN command to call a .BAC file under double 
precision BASIC or a .BAX file under single precision BASIC, BASIC can 
crash. You must explicitly specify the wrong file type to create this 
problem. BASIC executes properly when you rely on default file types. 


3.7 File Types 


When you call a file (with an OLD, RUN, or CHAIN command), BASIC looks 
first for a compiled image, and then for a .BAS image. If, for 
example, you specify OLD X.BAC and X.BAC does not exist, 
BASIC-11/RT-11 V2 continues to search for the .BAS file. 
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3.8 Device Handlers 

If a BASIC program that contains an array resides on a device whose 
handler is not resident, references you make to that device (with the 
OPEN statement, or the CHAIN command, for example) can cause the 


system to crash. Be sure to load the appropriate device handler to 
avoid this problen. : 


3.9 OPEN Statement 
When BASIC opens an integer virtual array, and the subscript you 


specify in the DIM# statement is 1 or 2 less than a muLEtpte of ae 
BASIC creates a file that is one block too long. 


3.10 Reading a String 

If you place a null string as the last item in a DATA statement or an 
input line, indicate’ it by two .adjacent quotation marks. The 
following example shows two null strings: one is indicated by two 
adjacent commas, and the other by two adjacent quotation marks. . 


10 DATA SrARCy ds sDEFs"* 


4.0 INSTALLATION PROCEDURE 


The BASIC-11/RT-11 V2 software kit contains three running versions | of 
BASIC: 


1. BASIC.SAV 

2. BAS8K.SAV 

3. BASICD.SAV 
The BASIC.SAV version includes all the optional features except the 
CALL statement. It is overlaid (it has overlay type 3) and does not 
include support for arithmetic hardware. Its base address is 1000. 
The BAS8K.SAV version can execute in 8K words of memory. It should 
only be used for 8K RT-1l systems. It does not include the following 
optional features: 

1. PRINT USING statement 

2. SUB command 

3. CALL statement 

4. RESEQ command 

5. Long error messages 
BAS8K is overlaid (it has overlay type 5) and does not include support 
for arithmetic hardware. In addition, BAS8K has a base address of 
700. 
BASICD.SAV has the same features and overlay type as BASIC.SAV. It 


Supports double precision floating point arithmetic and has a base 
address of 1200. 
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4.1 Linking BASIC 


If BASIC.SAV, BASICD.SAV, or BAS8K.SAV is suitable for your 
application, you do not need to relink BASIC. However, you can link 
BASIC to make any of these changes: 


1. Change the overlay type 

2. Add support for arithmetic hardware 

3. Add CALL support and assembly language routines 
4. Add or remove any optional features 


To link BASIC, you must run the program SUCNFG.BAS. This program asks 
you questions about BASIC's features and optional support. Then it 
creates an indirect command file that you must execute. This indirect 
file links BASIC according to the instructions you supplied to SUCNFG. 
The indirect file creates an executable version of BASIC (with any 
name you specify) that is tailored to-your requirements. 


Read Sections 4.2 and 4.3 to learn how to use the dialogue program, 
SUCNFG. Then read Section 4.4, which describes how to transfer the 
necessary files for linking BASIC from the software kit to your 
system. 


4.2 Using the Dialogue Program 


To invoke the dialogue program, you must first run BASIC. Then run 
SUCNFG: 


.R BASIC GED 
BASIC-11/RT-11 VO2-02 
OF TIONAL FUNCTIONS (ALL» NONEr OR INDIVIDUAL)? GED 


REALY 
RUN SUCNFG GED 
BASIC~11/RT-11 VO2 Configuration Frogram 


Tyre "Peret>" after any rromrt for HELP. 


»SAV and .COM file name (default is BASIC): 


When the dialogue prompts you for a .SAV and .COM file name, enter the 
name of the BASIC version you want to create. If you type only the 
RETURN key, the new version of BASIC is called BASIC.SAV. Note that 
if the new version is called BASIC.SAV, it replaces the version you 
are currently running. The listing shown in Figure 1 contains all the 
questions in the dialogue program, along with brief explanations. 
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+SAV and .COM file name (default is BASIC)? 

Enter the name in 6 or less characters for the name to be 
diver to the .SAY image of BASIC and the indirect file 

to be used to build BASIC. 


Bo vou want @ mar? CY or Ne default is Nd)? 


Tyre Y for ves or N for no. If the answer 
is Yr the next auestion will ask for 2@ name. 


MAF mame (default is same as «SAV mame): 
Enter <ret> or any ledal file name, 
BRacksround or Foresround ? (B or Fs default is Bs 


B creates a .SAV image to he run in the backsround. F creates 
a »REL image to be run in the foresround, 


To vou want FRINT USING? (CY or Né default is Ys 
Y includes the FRINT USING ortionry N does not. 
Tio vou want CALL surrort? CY or N3 default is Nd? 


Y includes CALL surrorty N does not. If CALL surrort is 
included the next auestion will handle the modules to 
be used with CALL in this BASIC. 


Enter module names Cone rer lined? 


On each line enter the name of a module to be included. Include your 
modified BSCLI»> your subroutines: and BSCLLE,r if it is needed. 

When a11 the modules have been entereds tyre <ret> alone. 

For more informations rlease see the documentation om CALL. 


Sinsle or Touble rrecision math? (5 or DF default is S)i 


S creates a BASIC that surrorts the 2-word flosting roint 
representation. Ii creates a BASIC that surrorts the 4-word 
floating roint rerresentation. 


Arithmetic hardware (NONE» EAE, EIS,» FISy or FFUs default is NONE): 


Arithmetic Hardware surrort is defined as follows? 
NONE - mo arithmetic hardwere is surrorted 
EAE - KELIA Extended Arithmetic Element is surrarted 


EIS - RELIE Extended Instruction Set is surrorted 
FIS - KELIF or KEVLIIF Floating Instruction Set is surrorted 
FFU - FFF Ila» By or C Floatins Point Unit is surrorted 


to you want the transcendental functions? (Y or N¥ default is Y)? 


Y includes the transcendental functions» N does mot. 
The transcendental functions are SQR: SIN: COSy ATNy» 
LOG: LOG10, and EXF. 


Figure 1 The Dialogue Text 
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Tio you want the SUB command? (Y or Nr default is Y? 


Y includes the SUB command,y N does mot. SUB allows editing 
without retyring the entire BASIC ststement,. 


Tio you want the RESEQ command? CY or Ny default is Y)? 


Y includes the RESEQ commands N does not. RESEQ allows the 
reseauencing of line mumbers in a BASIC rrosram. 


Do vou want longs error messases? (Y or Ne default is Y)? 


Y includes longs error messases: N does mot. 

Longs messades are several word explanations of am error 
condition. Short error messades are three character abbrevia-~ 
tions of the longs messades. 


Overlay structure ture (ly 2» 3» 4 or Se default is 1)? 


The overlay structures are described as follows: 

Tyre 1 ~ BASIC is not overlaid, 

Tyre 2 ~ The error messages are overlaid with a segment of 
of the edit rhase. 

Tyre 3 - The error messase Phaser edit rhaser and the 
execute ehase are overlaid. 

Tyre 4 - Similar to tyre 3 excert that the edit and execute 
Phases are overlaid internally. 

Tyre 5S - Similar to tyre 4 excert that the math rackader the 
I/O routines, are some other routines normally in the 
root segment are overlaid. 

The higher the overlay structure tyre numbers the less memory 

is reauired by BASIC. The saving in memory reauirements is made 
at the exrense of rerformance. Tyre 2» howevery has very 
minimal effect on the rerformance of BASIC: with a substantial 
saving im memory if longs error messages are used. Flease see 
the documentation for more information. 


Figure 1 The Dialogue Text (Cont.) 


NOTE 


If you interrupt SUCNFG (with CTRL/C, 
for example) you must restart it from 
the very beginning by typing RUN SUCNFG. 


4.2.1 Overlay Types - The dialogue program lets you specify how your 
version of BASIC is to be overlaid. The listing reproduced in Figure 
l summarizes the overlay types. Use overlay type 1. if conserving 
memory is not a concern on your system. Overlay type 2 is suitable 
for RKO5S and RKO6 systems where speed is more important than memory 
conservation. DIGITAL recommends type 2 for diskette-based systems. 
Overlay type 3 is suitable for RKO5 and RK06 systems where memory 
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conservation is more important than speed. Use type 3 for 
diskette-based systems if memory is at a premium. Use overlay type 4 
if you must strictly conserve memory. BAS8K.SAV, the smaller version 
of BASIC supplied in the software kit, uses overlay type 5. It has 
many small overlay sections and, therefore, executes slowly. Use type 
5 only for 8K systems. 


4.2.2 Arithmetic Hardware Support - The versions of BASIC provided in 
the software kit do not support arithmetic hardware. Specify EAE if 
your system has the KE11-A or KE11-B Extended Arithmetic Element, Specify 
EIS to support the KEI1-E Extended Instruction Set on a PDP=~11/35 
or PDP-11/40. Use EIS also for any PDP-11/34, 11/45, 11/50, 11/55, 
or 11/70 without the FP11 Floating Point Unit. Specify FIS if your 
system has the KE11-F or KEV-11 Floating Instruction Set. Specify FPU 
to include support for the FP11 Floating Point Unit. Use FPU also for 
any PDP-11/60 even if it does not have the FP11-E Floating Point Unit. 


4.2.3 Foreground Execution - To link BASIC to execute in the 
foreground with either the FB or XM monitor, simply type an F in 
response to the dialogue program's "Background or Foreground?" prompt. 
To execute BASIC in the foreground, use the FRUN command with the /N 
option. You must use this option to ensure that your program has 
adequate memory space for foreground execution. Section 4.3 contains 
an example of linking BASIC and executing it in the foreground. 


4.2.4 Assembly Language Routines - The versions of BASIC provided in 
the software kit do not support the CALL statement for assembly 
language routines. To include CALL support, you must first add _ the 
names of your assembly language routines to BSCLI.MAC, as described in 
the BASTC-11/RT-11 User's Guide. Then assemble the three MAC files 


together, supplying any file name for the resulting object file: 


»MACRO/ORJECTIMYCLI BSMAC+BSASM+BSCLI GED 


ERRORS DETECTED: 0 





Next, assemble your assembly language routines. You can place more 
than one routine in an object file. Type a Y in response to the 
dialogue program's "Do you want CALL support?" prompt. The dialogue 
next requests the module names. On the first line, enter the name of 
the .OBJ file you specified in the MACRO assembly shown above. On the 
next lines, enter the names of the .OBJ files that contain your 
assembly language routines. On the last line, enter BSCLLB if your 
assembly language routines use any routines supplied by BASIC (see the 
BASIC-11/RT-11 User's Guide). Finally, type only the RETURN key to 
terminate the list of module names. The following example shows the 
CALL support section of the dialogue: 


Do you want CALL sursort? (CY or Ni default is N)! Y@ED 


Enter module mames (one rer line)? MYCLI 
Module name? 
Module name? 
Module mame? 
Module mame? 
Module namet BRSCLLB@ED 
Module mame’s QED 
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4.2.5 Optional Features - You can link BASIC to add or delete support 
for any optional features. See the BASIC-11/RT-11 User's Guide for a 
discussion of the optional features. The text of the dialogue program 
(see Figure 1) lists the optional features you can add or delete at 
link time. 


4.3 Sample Dialogue 


The sample dialogue reproduced in Figure 2 shows how to link BASIC to 
run in the foreground. This example also requests a wide map listing 
(with /W), and adds support for EIS arithmetic hardware. The example 
then shows how to execute the indirect file and how to run the new 
version of BASIC in the foreground. 


«R_BRASIC GED 

BASIC-11/RT-11 YO2~-02 

OPTIONAL FUNCTIONS (ALL» NONE, OR INDIVIDUAL)? AGED 
READY 

RUN SUCNFG GED 

BASIC-11/RT-11 VO2 Confisuration Program 

Tyre "?Peret>" after any eromet for HELF. 

*SAY and .COM file name (default is BASIC)! MYBAS GED 
Do you want a mar? (Y or Ni default is N)? Y GET) 


«MAF mame (default is same as .SAY mame)! /W@ED 


Backstround or Foredround ? (BR or F$ default is B)? F GED 





Do vou want FRINT USING? (Y or N3 default is Y)t Y@ED 





To vou want CALL suprort? (Y or N# default is Nd! NG@D 





Single or Double rrecision math? (S$ or DF default is 5): [GED 





Arithmetic hardware (NONEr EAE, EIS, FIS» or FRUS default is NONE)! EIS@ED) 
Do vou want the transcendental functions? (Y or N$ default is YD)! Y GED 

Do you want the SUB command? (Y or Nr default is YD)? 

Do you want the RESEQ command? (Y or Ny default is YD? 


Yo sou want lonst error messases? (Y or N3 default is Y)! Y@ED 





Overlay structure ture (1» 2° 3, 4) or 5$ default is 1)3 3@er 





The followins GLOBALS will be undefined. These 
errors may be igmored, 
+ UACS: ..NRCS> and ..MSP4 (from mo CALL). 


To create the BASIC that you have Just definedys 

“sre "BYESret:" after BASIC erints "REALY'. When the sustem 
eromets for ineuty ture "@MYBAS<ret=" to link the new BASIC. 
See the User’s Guide for instructions om running 

BASIC in the Foresround. 


Figure 2 Sample Dialogue for Foreground 
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READY 
RYE 


»@MYBAS 


oR LINK . 

KMYRASs /W=/R21200// 
KBSPTRIs RSPAT » BSROD 

WKESRIDy BSFRO 

xBSCLIN 
*SU01IO,BSOTON.EISsRSOTIN.EIS 
*MSUIOFR sr SUIOFO 

XSUXIDly BSXOAs RSXORs BSX1A»BSX1B/0!1 
XBSFR1 » RBSCLSN 
XSUX2TD ee BSX2/031 

xXSUEL1IU,» BSEQsBSE1,sBSKEYS/O21 
*BSCMF y BSSUBs BSRSQ 
xXSUDTCM/O21 

*RSERR» RBSERMI/O% 1 

XxSUIMF sy BSFUNC »y SUOFPT/O32 

“// 

“MLINK-W-Undefined slobals! 

+ UACE 

» NECS 

+ MSFS 

xoOE 


»FRUN MYBAS/N! 3000,GED 


Fe 
BASIC~11/RT-11 YO2-03 
OFTIONAL FUNCTIONS (ALL NONE? OR INDIVIDUAL)? GRU A GED 


REALTY 
10 PRINT "WE ARE RUNNING IN FG NOW* QED 
RUNNH GED 


WE ARE RUNNING IN FG NOW 


READY 
BYE 


Re 
UNLOAD FG GED 


Figure 2 Sample Dialogue for Foreground (Cont.) 


4.4 Installation Instructions 


The BASIC-11/RT-11 software kit is distributed in the following forms: 


1 RKOS5 disk 
1 RKO6 disk 


1 RLO1 disk 


= 


9-track magtape 


N 


diskettes 


N 


diskettes 
17 
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When you receive the software kit, mount the distribution media 
{(write-protected, if possible) and copy all the files onto an empty 
disk or tape. Then store the original distribution media in a safe 


place. Use your own copy of the software for the following 
installation procedure. 


If a version of BASIC provided in the software kit (BAS8K.SAV, 
BASICD.SAV, or BASIC.SAV) is suitable for your application and you do 
not need to modify it, simply transfer the appropriate file from your 
copy of the distribution medium to your system device. Use a command 
Similar to this one: 


*COPY DX1iBASSK. SAV TK s @ED 
You can now execute BASIC by typing: 

+f BASSK GED 
If a version of BASIC provided in the software kit is not suitable for 
your application, you must use the program SUCNFG to relink BASIC. If 
your system device is an RKU5 or RKU6 disk, transfer all the files 
from your copy of the distribution medium to your system device. Use 
a command similar to this one: 


*COPY/SETOATE RKLIK.*K SY! 





for non-magtape distribution media, and 
»COPY RKItxk.* SY! GED | 
for magtape distribution medium. 


Run the dialogue program as described in Section 4.2. Then delete all 
the new files on your system device, except the new version of BASIC 
that you just created. Use this command to delete all the new files 
except for the new BASIC file: 


BASTO.SAYV 
+NELETESNEWFILES “EXCLUDE 


Filnems tye 


If your system device is a diskette or DECtape, your BASIC. software 
kit consists of two volumes. The first volume contains all the .SAV, 
-BAS, .DAT, and .MAC files. The second volume contains all the .OBJ, 
-EAE, .EIS, .FIS, and .FPU files. 


NOTE 


If your system device is DECtape, follow 
this procedure for diskette-based 
systems, but substitute DT for DX in the 
examples that follow. 


First, mount the first volume in drive 1. Assign DK: to that unit, 
as follows: 


»ASSIGN [X13 DK 3 GED 





Next, cun BASIC and SUCNFG, and answer the questions from the dialogue 
program. A sample run is reproduced in Figure 3. 
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+R BASIC @eD 
BASIC-11/RT-11 Vo2-02 
OF TIONAL FUNCTIONS (ALL» NONE» OR INDIVIDUAL)? A GED 


READY 

RUN SUCNFG GED 

BASIC-11/RT-11 VO2 Confisuration Frogram 

Tyre "?Teret>" after any eromet for HELF. 

SAV and .COM file mame (default is BASIC)! BASSM GED 


[lo you want a mar? (CY or Ni default is N)? N@ED 


Backsround or Foreground ? (BE or F? default is B): B GED 





fico you want FRINT USING? (CY or Ni default is Y)! N@ED 





Yo you want CALL surrart? (Y or N# default is N)! N@ED 


a 


Single or Double erecision meth? (S or [is default is S$): 
Arithmetic hardware (NONE, EAEr EIS» FIS+ or FFU# default is NONE)! NONE GED 
Tio you want the transcendental functions? (Y or N¥ default is YO: 

Do you want the SUE command? (CY or Ny default is Ys 

Yo you want the RESEQ command? (Y or Ne default is Y)! 


Do you want longs error messages? (CY or Ni default is Y)! N GED 





Overlay structure tyre (ly 2y Sr 4% or Ss default is 123 2 GET 





The following GLOBALS will be undefined. These 
errors may be ignored. 

a oFRUS (from mo FRINT USING). 

+ UACSs «NRC arid «MSPS (from mo CALL). 
SORT. SIM: COS: ATA: JALDGTO. EME Ss vand 

AL0G (from mo transcendental functions). 

+ -SUBS (from mo SUE command), 


++RES# Cfrom moa RESEQ command). 


To create the BASIC that vou have Just defined, 

ture "BYE<ret=" after BASIC erints “REALY’. When the sustem 
eromets for intuty tyre "@BASSMiret?" to link the new BASIC. 
You may tyre "R BASSMeret>" to run ite 


READY 


Figure 3 Sample Dialogue for Background 


When the dialogue program finishes, exit from BASIC and copy the new 
indirect file to your system device: 


EYE GED . 
.COFY BASSM.COM DX0O2BASSM.COM GED 


Now remove the first volume from drive 1 and mount the second volume 
there. Execute the indirect file to link BASIC, as Figure 4 shows. 
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+ @UX0tRASSM.COM 


eR LINK 
XEASSM=/B31000// 
XESFTRS»y RSFATsESROS 
*BSR1S,yBSFRON 

*ESCLIN 

xXSUO1LIDy BSOTOS 

XSUIOPRs SUTOFO,SUDTOM 
KESXOAyESXOReKSX2 +» BSK1A 
KBSX1By RSFRIN:y BSCLSN 
*XBSEO,s BSCMF 
*XBESSUEBN ry RBSRSQN 
XSUE1INYBSEL»BSKEYS/G21 
XESERR» RSERMS/Ot1 
XSUIMF ss RSFUNC sy SUOFT/0O22> 
xK// 

PLINK-W-Undefined slobals? 
+ UACS 

++ SUBS 

+ RES 

++ PRUS 

+ «NRCS 

++ MSFS 

x7C 


Figure 4 Linking BASIC 


Next, copy the resulting .SAV (or .REL for foreground) file 
system device, and reassign DK: to DX0:. 


»COFY BASSM.SAV [x02 BASS. SAV GED 
ASSIGN DXO! Lk: GED 
You can now execute your new version of BASIC: 


«+R BASSM GED 
BASIC-LI/RT~11 VO2-08 
OFTIONAL FUNCTIONS (ALL, NONE» OR INDIVITUAL)? 


5.0 THE CONVERTING PROGRAM 


to your 


The BASIC software kit contains a converting program, SUCVT, that 
helps you modify programs written under BASIC/RT-11 V01B so that they 


execute properly under BASIC-11/RT-11 V2. Use this program to 


modify 


all VO1B BASIC programs that contain any of the following items: 


e Virtual arrays 
e User-defined functions that return strings 


@® REM statements that include a backslash (\) 
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e BIN or OCT functions that do not contain parentheses 
e Line numbers greater than 32767 


e DATA statements on multi-statement lines 


e cCHRS or STRS functions 
@ RANDOMIZE statements 
e CALL statements 


See Section 2.0 of this document for a summary of how the items listed 
above have changed in V2 BASIC. 


5.1 Starting the Converting Program 


To use the converting program, first make sure that the following two 
programs, which are provided in the software kit, reside on your 
system device: 


1. SUCVT.BAS 
2. SUCVT1.BAS 

Then start BASIC. Respond to the READY prompt by typing: 
RUN SUCYT 


The converting program first requests the name of the. file you. need to 
convert. Enter the input file specification in the standard RT-11 
format (dev:filnam.typ). Then the program requests the name _ to be 
assigned to the resulting converted program. Enter the output file 
specification. If you type only the RETURN key for the output fiie 
name, the converting program examines the input file but does not 
create a converted output file. If you omit the file type in the 
input or output file specification, the converting program uses .BAS. 
The following is an example of the initial dialogue with the 
converting program: 


INFUT FILE NAME? CVTEST GED 
OUTPUT FILE NAME? CVOUT GED 


Next, the converting program requests the items you need to check for 
V2 BASIC compatibility (a complete list of the possible items is 
reproduced at the beginning of Section 5.0): 


WHICH FEATURES WOULT YOU LIKE TO CHECK (ALL»y INDIVIDUAL SELECTION)? 


To check all possible items for V2 BASIC compatibility, type an A. 
Typing only the RETURN key is equivalent to typing an A. If you type 
an A (or a RETURN), the converting program begins to examine the input 
file. 


If you type an I, the converting program lists each feature 
separately. If you need to examine a particular item, type a ¥ (or a 
RETURN). If you do not need to check a feature, type an N. The 
following is a sample dialogue: 
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WHICH FEATURES WOULD YOU LIKE TO CHECK (ALL» INDIVIDUAL SELECTION)? I GED 
VIRTUAL ARRAYSCY OR N) ? Y @ED 

DEF STATEMENTS(Y OR N) ? Y.GED 

REM STATEMENTS(Y OR N) 7? NG@ED 

BIN AND OCT USAGECY OR N) 7? Y@ED 

STR$ ANI CHR& USAGECY OR N) 7? YQED 

LATA STATEMENTS(Y OR N) 7? Y¥ 

RANDOMIZE STATEMENTS(Y OR N) ? NGED 

CALL STATEMENTS(Y OR N) ? Y GED 


As a result of the dialogue shown above, the converting program would 
check all items except REM and RANDOMIZE statements. When you respond 
to the last line of the dialogue, the converting program begins to 
examine the input file. 


5.2 Interacting with the Converting Program 


As the converting program examines the input file, it searches for the 
items that you requested in the dialogue. When it finds an occurrence 
of a requested item, it prints the item (in most cases) and gives you 
an opportunity to modify a program line or add new program lines. 


When the converting program finds a virtual array OPEN statement, it 
prints the existing array name and requests a new array name. If you 
type just the RETURN key, the converting program repeats the request. 
If you type LIST, the converting program prints the program line that 
contains the OPEN statement, then repeats the request for a new array 
name. When you type a new virtual array name, the converting program 
replaces all occurrences of the existing mame with the new name. Make 
sure that the new name you type is not used already as a variable in 
the program. After you enter a new virtual array name, the converting 
program requests a channel number for that array. If you type only 
the RETURN key, the converting program repeats the request. Make sure 
the channel number you enter is in the range 1 to 12 and is not used 
in any OPEN statement already in the program. 


When the converting program finds a DEF statement, it prints the 
existing function name and requests a new function name. If you type 
just the RETURN key, the converting program retains the existing 
function name and continues processing the input file. If you type 
LIST, the converting program prints the program line that contains the 
DEF statement, then repeats the request. When you type a new function 
name, the converting program replaces all occurrences of the existing 
name with the new name. Again, make sure that the new name you type 
is not used in any other DEF statement in the program. 


The converting program automatically corrects program lines that 
contain REM statements with a backslash (\) and those that use the BIN 
or OCT functions without parentheses. For REM statements, the 
converting program substitutes the words "BACK-SLASH" for the actual 
backslash character (\). For BIN and OCT functions, the converting 
program supplies the missing parentheses. The converting program does 
not request any information from you when it examines REM statements 
and BIN and OCT functions. 


The converting program always checks the line numbers in your program 
to see if there are line numbers greater than 32767. If the 
converting program detects such a line number, it prints the line 
identified by that line number and requests a new line number for it. 
Respond by typing a new line number; do not retype the entire 
statement on that line. Note that if you do not enter a new line 
number that is less than or equal to 32767, the program cannot execute 
under V2 BASIC. 
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When the converting program finds a CHR$ or STR$ function, a CALL or a 
RANDOMIZE statement, or a DATA statement that is on a multi-statement 
line and is not the last item, it first prints the appropriate warning 
message from the following list: 


WARNING! FUNCTION CHRS HAS CHANGED 

WARNING! FUNCTION STR HAS CHANGED 

CALL INTERFACE HAS CHANGED 

FUNCTION OF RANDOMIZE STATEMENT HAS CHANGED 
DATA STATEMENT NOT LAST 


Then the converting program prints the line that contains the function 
or statement and requests a new line. If you type only the RETURN 
key, the converting program leaves the existing. program line 
unchanged. If you type a new program line, the converting program 
deletes the original line and inserts the new line. The. converting 
program continues to request new lines so that you can properly modify 
your V01B program. Make sure that the new lines you type do not have 
the same line numbers as existing program lines, except for the line 
number of the deleted line. When you are finished, respond to the new 
line request by typing just the RETURN key. 


When the converting program finishes examining the input file it asks 
if you need to convert another program: 


CONVERSION COMPLETE. 
ANOTHER CONVERSION? (¢Y OR ND 7 


Type a Y (or the RETURN key) to restart the converting program. Type 
an N to terminate the program and return control to BASIC. 


5.3 Converting a Sample Program 

This section contains a sample V01B BASIC program, a reproduction of 
the converting program dialogue, and a listing of the resulting 
converted file. Read the dialogue carefully. Then compare the vVO1B 
BASIC program with the V2 BASIC version. 


Figure 5 is a listing of a V01B BASIC program called CVTEST.BAS. 
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100 DEF FNV(S)=CHRS$(S) 

200 DEF FNX(T)=T+T"2 

300 OPEN ’TEST1.DAT’ AS FILE #6 

400 OPEN ‘TEST2.DAT’ FOR OUTFUT(4) AS FILE #4 
500 OPEN ’TEST3.DAT’ FOR OUTPUT AS FILE VF1(25) 
600 OPEN ‘TEST4.DAT’ FOR OUTFUT(10) AS FILE VF2%(25) 
700 OPEN ‘’TESTS.BAT’ FOR OUTFUT AS FILE VF5$(464) 
750 OPEN ‘’TESTS.DAT’ AS FILE VF6$(6)=16 

800 REM TEST PROGRAM FOR V1B 

900 REM CONTAINS A \ FOLLOWEDBYMORETEXT 

1000 DATA ‘NOT’ s’AT’» ‘END’ »’OF’s’A’s‘LINE‘’\GO TO 1100 
1100 K=0CT(‘7077) 

1200 PRINT K 

1250 PRINT K+VF1i¢(4) 

1300 K=0CT ‘707° 

1400 FRINT K 

1450 PRINT K+VF2(3) 

1500 K=BIN(’1010107) 

1600 PRINT K 

1700 K=BIN‘101010’ 

1800 PRINT K 

1900 K=BIN‘’10101’+12 

2000 FRINT K 

2100 FS=’GTY’&FNV(S) 

2200 PRINT FNX(9) 

2300 PRINT FNV(4) »FNX(CVF1(7)> 

2400 LET VFS(S)=’NOWIS THE ‘&STRS(FNX(1)) 

2500 RANDOMIZE 

2600 CALL “HYFOT’ (GrKrZ) 

2800 CLOSE VFi 

2900 CLOSE VFS 

60000 END 


Figure 5 V01B BASIC Program 


Figure 6 is a sample dialogue with the converting program. Note that 
all the possible features are to be checked for V2 BASIC 
compatibility. 
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REALY 
RUN SUCUT 


INPUT FILE NAME? CVTEST GED 
OUTPUT FILE NAME? CVUOUT Ren) 


WHICH FEATURES WOULD YOU LIKE TO CHECK (ALL» INDIVIDUAL SELECTION)? I GED 


VIRTUAL ARRAYS(Y OR N) ? 

DEF STATEMENTS(Y OR ND ? ¥ Get 

REM STATEMENTS’ (Y OR N) ? 
BIN AND OCT USAGECY OR N) 7? YQ@ED 
STR$ ANI CHR$ USAGE(Y OR N) 7? Y@ED 
DATA STATEMENTS(Y OR ND ? Y@ED 
RANDOMIZE STATEMENTSCY OR N) ? Y@ED 
CALL STATEMENTS(Y OR N) ? YGED 
FUNCTION NAMES FNY 

NEW NAMES ? FNUS@ED 

FUNCTION NAME? FNX 

NEW NAME! 7 LIST GED 

200 DEF FNX(T)=T+T72 

NEW NAME: ? GED 

VIRTUAL ARRAY NAME VFi 

NEW NAME ? C GED 

CHANNEL NUMBER ? 1@ED 

VIRTUAL ARRAY NAME VF2% 

NEW NAME ? C% GED 

CHANNEL NUMBER 7 2 GED 

VIRTUAL ARRAY NAME VFSS 

NEW NANE ? C% GED 

CHANNEL NUMBER ? 3 GED 

VIRTUAL ARRAY NAME VF4$ 

NEW NAME ? Ci¢ GED 

CHANNEL NUMBER ? 5 GED 

LINE NUMBER GREATER THAN MAX 

OLD- LINE? 60000-END 

NEW LINE NUMBERS? 32000 GED 
WARNING! FUNCTION CHRS HAS CHANGED. 
OLD LINE ¢ 100 DEF FNV$(S)=CHR$(S) 
NEW LINE i + GED 

LATA STATEMENT NOT LAST 


8 














OLD LINE $ 1000 DATA ‘NOT’s‘AT‘’s ‘END’ » OF’: ’A’s’LINE’\GO TO 1100 
NEW. LINE. $ ? 1000 GOTO 1100@ED | 

NEW LINE ? ? 1010 DATA ‘“NOT‘’s‘AT‘’»s ‘END’ »’OF’s’A’s “LINE” GED 

NEW LINE : ? @ED 

WARNING! FUNCTION STR$ HAS CHANGED. 

OLD LINE $ 2400 LET C$(5)=’NOWIS THE ‘&STRS(FNX(1)) 

NEW LINE $ ? GED 

FUNCTION OF RANDOMIZE STATEMENT HAS CHANGED 

OLD LINE $ 2500 RANDOMIZE 

NEW LINE ? 


? 50 RANDOMIZE GED 
NEW LINE : ?@ED 


CALL INTERFACE HAS CHANGED 

OLD LINE : 2600 CALL ‘HYFOT’(GekyZ) 
NEW LINE : ? GED 

CONVERSION COMPLETE. 

ANOTHER CONVERSION? (CY OR N) ? NGED 


READY 


Figure 6 Converting Program Dialogue 


Figure 7 is the listing of the resulting converted program, 
CVOUT.BAS: 
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OLD CVOUT 


READY 
LIST GED 


CVOUT 17-AUG-77 =11337319 


50 RANDOMIZE 

100 DEF FNV$(S)=CHR$(S) 

200 DEF FNX(T)=TtT"2 

300 OPEN ‘TEST1.DAT’ AS FILE #6 

400 OPEN ’TEST2.DAT’ FOR OUTPUT AS FILE #45 FILESIZE 4 
500 OPEN ‘TEST3.DAT’ FOR OUTPUT AS FILE #1 \ DIM #19C(25) . 
600 OPEN ‘TEST4.DAT’ FOR OUTPUT AS FILE #2, FILESIZE 10 \ DIM #2,C“(25) 
700 OPEN ‘TESTS.DAT‘’ FOR OQUTFUT AS FILE #3 \ DIM #37C#(464)=32 
750 OPEN ‘TEST4.DAT’ AS FILE #5 \ DIM #5701$(6)=16 

800 REM TEST FROGRAM FOR Vik 

900 REM CONTAINS A "BACK-SLASH® FOLLOWEDBYMORETEXT 
1000 GO TO 1100 

1010 DATA ‘NOT’ s’AT’s END’ + OF ’s’A‘s ‘LINE’ 

1100 K=0CT(’707°) 

1200 PRINT K 

1250 FRINT KtC(4) 

1300 K=0CT(“7077) 

1400 PRINT K 

1450 PRINT K+C%(3) 

1500 K=BIN(’1010107) 

1600 PRINT K 

1700 K=BIN(‘101010°) 

1800 PRINT K 

1900 K=BIN(‘10101’)+12 

2000 FRINT K 

2100 P$=’GTY’ &FNYUS(S) 

2200 PRINT FNX(?) 

2300 PRINT FNV$(4)sFNX(CC7)) 

2400 LET C$(5)=’NOWIS THE ‘&STRS(FNX(1)) 

2600 CALL ‘HYFOT’(GrKrZ) 

2800 CLOSE 1 

2900 CLOSE 3 

32000 END 


READY 


Figure 7 V2 BASIC Program 


5.4 Compiling the Converting Program 


If you need to use the converting program frequently, compile’ the 
program so that it executes more efficiently. See Figure 8 for the 
commands to do this. 
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OLD SUCYVT 


REALTY 


REALLY 
OLL SUCVT1 


REARY 
COMPILE GED 


READY 


Figure 8 Compiling the Converting Program 
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conservation is more important than speed. Use type 3 for 
diskette-based systems if memory is at a premium. Use overlay type 4 
if you must strictly conserve memory. BAS8K.SAV, the smaller version 
of BASIC supplied in the software kit, uses overlay type 5. It has 
Many small overlay sections and, therefore, executes slowly. Use type 
5 only for 8K systems. 


4.2.2 Arithmetic Hardware Support - The versions of BASIC provided in 
the software kit do not support special arithmetic hardware. Specify 
EAE if your system has the KEI11-A or KEI11-B Extended Arithmetic 
Element. Specify EIS to support the KE11-E Extended Instruction Set. 
Use EIS also for.any PDP 11/34, 11/45, 11/50, 11/55, or 11/70 without 
the FP11 Floating Point Unit. Specify FIS if your system has the 
KE11-F or KEV-11 Floating Instruction Set. Specify FPU to include 
support for the FP1l Floating Point Unit. Use FPU also for any PDP 
11/60 without the FP11-E Floating Point Unit. 


4.2.3 Foreground Execution - You must link BASIC to execute in the 
foreground with either the FB or XM monitor. To do this, simply type 
an F in response to the dialogue program's "Background or Foreground?" 
prompt. To execute BASIC in the foreground, use the FRUN command with 
the /N option. Section 4.3 contains an example of linking BASIC and 
executing it in the foreground. 


4.2.4 Assembly Language Routines - The versions of BASIC provided in. 
the software kit do not support the CALL statement for assembly 
language routines. To include CALL support, you must first add the 
names of your assembly language routines to BSCLI.MAC, as described in 
the BASIC-11/RT-11 User's Guide. Then assemble the three .MAC files 
together, supplying any file name for the resulting object file: 


+MACRO/ORJECTIMYCLI BSMACTBRSASMLBSCLI 
ERRORS DETECTED oO 


Next, assemble your assembly language routines. You can place more 
than one routine in an object file. Type a Y in response to the 
dialogue program's "Do you want CALL support?" prompt. The dialogue 
next requests the module names. On the first line, enter the name of 
the .OBJ file you specified in the MACRO assembly shown above. On the 
next lines, enter the names of the .0OBJ files that contain your 
assembly language routines. On the last line, enter BSCLLB if your 
assembly language routines use any routines supplied by BASIC (see the 
BASIC~-11/RT-11 User's Guide). Finally, type only the RETURN key to 
terminate the list of module names. The following example shows the 
CALL support section of the dialogue: 


[Do vou want CALL surrort? (CY or NF default is N)! Y@ED 


Enter module mames (ome rer line)? MYCLI GED 
Module nmamet MOL1@ED 

Module mame: MOD2 Ger 

Module name! MODZ@eED 

Module mame? MOD4GED 

Module namet BSCLLE@ED 

Module name! 
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4.2.5 Optional Features - You can link BASIC to add or delete support 
for any optional features. See the BASIC-11/RT-11 User's Guide for a 
discussion of the optional features. The text of the dialogue program 
(see Figure 1) lists the optional features you can add or delete at. 
link time. 


4.3 Sample Dialogue 


The sample dialogue reproduced in Figure 2 shows how to link BASIC to 
run in the foreground. This example also requests a wide map listing 
(with /W), and adds support for EIS arithmetic hardware. The example 
then shows how to execute the indirect file and how to run the new 
version of BASIC in the foreground. 


+R_BASIC GED 
BASIC-11/RT-11 VO2~-02 
OPTIONAL FUNCTIONS (ALL» NONE? OR INDIVIDUAL)? AGED 





READY 

RUN SUCNFG GED 

BASIC-11/RT-11 VO? Confisuration Program 

Tyre "?iret>" after any rromret for HELP. 

»SAV and .COM file name (default is BASIC)! MYBAS GED 
Do vou want a mar? (Y or N?# default is N)!$ YG@ED 

»MAP mame (default is same as .SAV mame)! /W@ED 


Rackdround or Foresround ? (BR or Fi default is &)! F@ED 





Do you want FRINT USING? (CY or Ni default is Y)! YQ@ED 





Do vou want CALL surrort? (Y or N? default is N)! NGED 





Single or Double rrecision math? (S or Iii default is $)? 

Arithmetic hardware (NONE, EAE» EIS» FIS: or FPUS default is NONE)! EISGED 
Do you want the transcendental functions? (CY or N# default is Y)! 

No you want the SUB command? (Y or Nr default is Y)! 

To vou want the RESEQ command? (Y or Ny default is Y)? 


Qo you want lonst error messages? (Y or N} default is Y)! Y@ED 





Overlay structure ture (1y 27 3y 49 or Ss default is 1)% 3GET 





The following GLOBALS will be undefined. These 
@rrors may be idnmored. 
+ UACS:s «NRCS: and ..MSPS (from ro CALL). 


To create the BASIC that vou have Just defined, 

tyre "BYEcret>" sfter BASIC erints "READY. When the system 
Prompts for imeut, ture "@MYBAS<“ret*" to link the new RASIC. 
See the User’s Guide for instructions on running 

BASIC in the Foreground. 


Figure 2 Sample Dialogue for Foreground 
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REALY 
RYE GED 


-@MYBAS 


«Rk LINK 

KMYBASs /W=/RI1200// 

MESPTRDs BSFATs BSROD 

*XBSRLIDs BSFRO 

*BSCLIN 
*¥SUOLIGsBSOTOD,EIS,sBSOT1IN.EIS 
xSUIOPR » SUTOPO 

*KSUXIDts BSXOAs BSXOB+s BSX1A»BSXIB/Oi1 
XESFR1»BSCLSN 
XSUX21D,BSX2/0%1 

XSUE LID BSEOsESE1sRSKEYS/031 
*BSCMF y BSSUBs BSRSQ 
MSUIITCEM/OE1 

¥RSERRs BSERML/031 

*xSUIMF » BSFUNC y SUDFT/032 

Sf 

@LINK-W-Undefined slobals? 

+ UACS 

++ NRCS 

+ -MSFS 

xeC 


»FRUN MYBAS/N!3000,.@ED 

F> 

BASIC-1L1/RT-11 YO2-03 

QFTIONAL FUNCTIONS (ALL+ NONE, OR INDIVIDUAL)? GIRL A GED 
READY =o: 

10 PRINT "WE ARE RUNNING IN FG NOW" GED 

RUNNH GED 

WE ARE RUNNING IN FG NOW 


REALY 
BYE GED 


Ry 
UNLOAD FG 


* 


Figure 2 Sample Dialogue for Foreground (Cont.) 


4.4 Installation Instructions 
The BASIC-11/RT-11 software kit is distributed in the following forms: 
1 RKOS disk 
1 RKO6 disk 
l magtape (7- or 9~track) 
2 diskettes 


2 DECtapes 
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When you receive the software kit, mount the distribution media 
(write-protected, if possible) and copy all the files onto an empty 
disk or tape. Then store the original distribution media in a_ safe 
place. Use your own copy of the software for the following 
installation procedure. 


If aversion of BASIC provided in the software kit (BAS8K.SAV, 
BASICD.SAV, or BASIC.SAV) is suitable for your application and you do 
not need to modify it, simply transfer the appropriate file from your 
copy of the distribution medium to your system device. Use a command 
similar to this one: 


»COFY DX1LtKhASSK.SAV DK? 


You can now execute BASIC by typing: 
+R BASBK 


If a version of BASIC provided in the software kit is not suitable for 
your application, you must use the program SUCNFG to relink BASIC. If 
your system device is an RKU5 or RKO6 disk, transfer all the files 
from your copy of the distribution medium to your system device. Use 
a command similar to this one: 


«COPY RKLtk.*k DK? GED 


Run the dialogue program as described in Section 4.2. Then delete all 
the new files on your system device, except the new version of BASIC 
that you just created. Use this command to delete all the new files 
except for the new BASIC file: 


| RASIC.SAV 
DELETE/NEWFILES/EXCLUDE 
filnam.etyurJ 


If your system device is a diskette or DECtape, your BASIC. software 
kit consists of two volumes. The first volume contains all the .SAV, 
-BAS, .DAT, and .MAC files. The second volume contains all the .OBJ, 
-EAE, .EIS, .FIS, and .FPU files. 


NOTE 
If your system device is DECtape, follow 
this procedure for diskette-based 


systems, but substitute DT for DX in the 
examples that follow. 


First, mount the first volume in drive 1. Assign DK: to that unit, 
as follows: 


+ASSIGN UX1i [iki GED 


Next, run BASIC and SUCNFG, and answer the questions from the dialogue 
program. A sample run is reproduced in Figure 3. 
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